1. AI Agent의 정의
YABOAZ에서 AI Agent는 사람을 대체하는 자동화 로봇이 아닙니다. 특정 업무 목적을 위해 Evidence, 온톨로지, 데이터, 규칙, 워크플로를 활용하여 판단을 지원하고 실행을 준비하는 디지털 업무 구성원입니다.
정보 수집문서·로그·인터뷰·시스템 데이터를 읽고 정리합니다.
상황 해석현재 상태와 이벤트를 온톨로지 기준으로 이해합니다.
판단 지원위험도·우선순위·예외 여부를 추천합니다.
행동 제안다음 업무, 승인 요청, 담당자 배정을 제안합니다.
기록 생성근거·추천·승인·실행 결과를 저장합니다.
학습 지원사람의 수정·승인 결과를 개선 데이터로 축적합니다.
Human Gate고위험 실행은 사람에게 검토를 요청합니다.
자산화검증된 Agent 사양을 다음 프로젝트에 재사용합니다.
AI Agent는 “답변하는 AI”가 아니라 “업무 안에서 역할을 수행하는 AI 실행 단위”입니다.
Evidence → Ontology → Judgment → Agent Role → Human Gate → Workflow → KPI → Asset
2. 일반 챗봇과 AI Agent의 차이
| 구분 | 일반 챗봇 | YABOAZ AI Agent |
|---|---|---|
| 목적 | 질문에 답변 | 특정 업무 역할 수행 |
| 입력 | 사용자의 자유 질문 | Evidence·데이터·상태·이벤트 |
| 기준 | 모델의 일반 지식 | 온톨로지·조직 규칙·정책 |
| 출력 | 텍스트 답변 | 판단·추천·승인 요청·기록 |
| 실행 | 워크플로와 약하게 연결 | 도구·API·Human Gate와 연결 |
| 책임 | 승인·권한 구조가 불명확 | 권한·승인자·금지 행동·감사 로그 명확 |
| 검증 | 대화 만족도 중심 | 정확도·채택률·처리시간·KPI |
| 자산화 | 재사용 사양이 부족 | Agent Spec과 템플릿으로 재사용 |
3. 08단계의 위치와 핵심 산출물
01 온보딩 → 02 Evidence → 03 2A4 → 04 Discovery → 05 인터뷰 → 06 온톨로지 → 07 AI 판단 → 08 AI Agent → 09 워크플로 → 10 UI·데이터 → 11 MVP → 12 Bootcamp → 13 자산화
입력 자료
| 입력 | Agent 설계에서의 활용 |
|---|---|
| 문제정의서·현장 탐색·인터뷰 | Agent가 해결할 업무와 실제 사용자 흐름을 확인합니다. |
| Evidence·온톨로지 7요소 | 판단 근거, 객체·상태·이벤트·규칙·행동을 연결합니다. |
| AI 판단 시나리오 | Agent가 수행할 질문과 출력 결과를 정의합니다. |
| 데이터·API·보안 정책 | 읽을 데이터, 사용할 도구, 권한·금지 범위를 결정합니다. |
핵심 산출물
목적·역할 정의왜 필요한 Agent인지와 수행·제외 범위
입력·참조 지식데이터 출처, Evidence, 온톨로지, 규칙
도구·API 목록검색·조회·승인·알림·로그·KPI 도구
권한·금지 행동Read부터 승인 후 실행까지 권한 구분
Human Gate승인자·조건·대체 승인·제한 시간
실패 처리데이터 부족·충돌·API 오류·롤백
감사 로그입력·근거·판단·승인·실행 추적
Agent KPI·사양서성과 기준과 공식 재사용 문서
4. AI Agent 설계 전체 흐름 10단계
01
Agent 목적 정의
해결 문제, 반복성, 기대 효과, 실패 위험, MVP 범위를 명확히 합니다.
02
역할과 업무 범위 설정
주요 역할·보조 역할·수행 범위·수행하지 않는 역할을 분리합니다.
03
입력 데이터 정의
Evidence, 객체·상태·이벤트, 규칙·이력, 사용자 입력과 갱신 조건을 지정합니다.
04
참조 지식·온톨로지 연결
도메인 용어집, 온톨로지, 매뉴얼, 판단·금지 규칙, 과거 사례를 연결합니다.
05
판단 질문·출력 정의
판단 결과·추천 행동·근거·신뢰도·대안·리스크·승인 필요 여부를 설계합니다.
06
도구와 API 정의
검색·데이터 조회·상태 업데이트·알림·승인 요청·리포트·KPI 도구를 등록합니다.
07
권한 정의
Read, Recommend, Request, Draft, 승인 후 실행, 제한적 자동 실행으로 구분합니다.
08
금지 행동·Human Gate 연결
AI 단독 실행 금지 영역과 사람 승인 조건을 연결합니다.
09
실패 처리·감사 로그 설계
데이터 부족, 충돌, API 오류, 권한 부족, 실행 실패와 기록 항목을 정의합니다.
10
KPI·자산화 기준 정의
정확도·채택률·처리시간·오류율과 다른 프로젝트 재사용 조건을 정합니다.
5. Agent 역할·입력·참조 지식
Agent 역할 유형
Evidence Agent자료와 증거를 수집·분류·요약
Discovery Agent현장 신호와 문제 패턴 정리
Ontology Agent객체·관계·상태·이벤트 후보 도출
Judgment Agent위험도·우선순위·적합성 판단
Workflow Agent다음 업무 흐름과 담당자 추천
Approval Agent승인 필요 여부와 승인자 관리
KPI Agent실행 결과와 성과 분석
Assetization Agent검증된 결과를 자산 후보로 정리
입력 데이터 정의표
| 데이터 | 출처 | 필수 | 갱신 | 품질 조건 |
|---|---|---|---|---|
| 센서 감지 로그 | 센서 시스템 | 필수 | 실시간 | 시각·위치 포함 |
| 센서-구역 매핑 | 시설 DB | 필수 | 변경 시 | 최신 공간 정보 |
| 주변 센서 상태 | 센서 시스템 | 필수 | 실시간 | 누락 없음 |
| 오경보 이력 | 이력 DB | 선택 | 월 단위 | 최근 12개월 |
| 관리자 확인 메모 | 사용자 입력 | 선택 | 수시 | 작성자·시각 기록 |
온톨로지 연결
| Agent 기능 | 참조 요소 | 판단 연결 |
|---|---|---|
| 센서 알림 해석 | 센서·구역·상태·이벤트 | 현재 상황과 발생 원인 |
| 위험도 판단 | 센서 상태·구역 위험도·규칙 | 정상·주의·위험 추천 |
| 경로 영향 확인 | 구역-경로 관계·경로 상태 | 안전·차단·대체 경로 |
| 승인 필요 여부 | 위험도·행동·승인 규칙 | Human Gate 분기 |
6. 도구·API·권한·금지 행동
도구/API 정의표
| 도구/API | 용도 | 입력 | 출력 | 권한 |
|---|---|---|---|---|
| SensorLog API | 센서 상태 조회 | 센서ID·시간 | 센서값·상태 | Read |
| SpaceMap API | 구역·경로 조회 | 구역ID | 위치·연결 경로 | Read |
| Approval API | 승인 요청 생성 | 추천·승인자 | 요청 ID | Request |
| Notification API | 승인 후 알림 | 대상·메시지 | 발송 결과 | 승인 후 실행 |
| AuditLog API | 판단·승인·실행 기록 | 실행 정보 | 로그 ID | Write |
권한 수준
| 수준 | 허용 내용 | FireNavi 예시 |
|---|---|---|
| Read | 데이터·Evidence 조회 | 센서 로그 확인 |
| Recommend | 판단 결과·행동 추천 | 위험도·경로 추천 |
| Request / Draft | 승인 요청·문서 초안 작성 | 관리자 승인 요청 |
| Execute with Approval | 사람 승인 후 실행 | 대피 알림 발송 |
| Auto Execute | 낮은 위험 업무 자동 실행 | 감사 가능한 내부 태깅 |
| Prohibited | 수행 금지 | 대피 명령 최종 결정 |
금지 행동 문장
본 Agent는 위험도 추천과 승인 요청을 수행할 수 있으나, 관리자 승인 없이 대피 안내를 발송하거나 대피 명령을 최종 확정할 수 없습니다.
7. Human Gate·실패 처리·감사 로그
Human Gate 연결표
| Agent 판단 | Gate 조건 | 승인자 | 승인 후 행동 |
|---|---|---|---|
| 위험도 높음 | 대피 안내 필요 | 안전관리자 | 대피 안내 생성·발송 |
| 경로 차단 필요 | 경로 사용 불가 | 시설관리자 | 경로 제외·재추천 |
| 우선 대상 있음 | 취약자 정보 포함 | 안전담당자 | 개별 알림 |
| 신뢰도 낮음 | 70% 미만 | 현장관리자 | 수동 검토 |
실패 처리표
| 실패 유형 | Agent 행동 | 사람 개입 | 기록 |
|---|---|---|---|
| 필수 데이터 누락 | 판단 보류 | 담당자 확인 요청 | 누락 데이터 |
| 데이터 충돌 | 충돌 표시 | 승인자 판단 요청 | 충돌·결정 로그 |
| API 오류 | 재시도 후 중단 | 수동 처리 전환 | 오류·복구 로그 |
| 권한 부족 | 접근 차단 | 권한 관리자 요청 | 권한 이벤트 |
| 실행 실패 | 롤백 또는 중단 | 운영자 확인 | 실행 결과·롤백 |
감사 로그 필수 항목
Agent ID·시각어떤 Agent가 언제 실행되었는가
입력·Evidence무엇을 읽고 어떤 근거를 사용했는가
판단·신뢰도무엇을 판단하고 얼마나 확신했는가
추천·권한무엇을 제안하고 어떤 권한을 사용했는가
승인 결과누가 승인·반려·수정·보류했는가
실행 결과실제 행동과 성공·실패 결과
예외오류·충돌·에스컬레이션 내용
KPI 영향성과와 개선 결과
8. FireNavi 적용·실습·완료 기준
Agent 1. 위험도 판단 Agent
| 항목 | 내용 |
|---|---|
| 목적 | 센서 알림 발생 시 실제 위험 가능성 판단 |
| 입력·지식 | 센서값·위치·주변 센서·오경보 이력·센서·구역·상태·이벤트 |
| 출력·행동 | 정상·주의·위험, 근거·신뢰도, 위험 이상이면 승인 요청 |
| 권한·금지 | Recommend·Request / 대피 명령 단독 확정 금지 |
| KPI | 판단 정확도·승인시간·오경보 감소율 |
Agent 2. 안전 경로 추천 Agent
| 항목 | 내용 |
|---|---|
| 목적 | 대피자 위치 기준 안전 경로와 대체 경로 추천 |
| 입력 | 대피자 위치·구역 위험도·경로 상태·혼잡도 |
| 규칙 | 위험 구역과 연결된 경로 제외, 혼잡도 낮은 경로 우선 |
| Human Gate | 대피 안내 전 안전관리자 승인 |
| KPI | 경로 정확도·대피 완료율·사용자 수정률 |
Agent 간 협업
센서 감지 → 위험도 판단 Agent → 안전 경로 추천 Agent → 승인 Agent → 알림 Agent → KPI Agent → 자산화 Agent
Agent 사양서 표준 항목
기본Agent ID·이름·목적·해결 문제·주요 사용자
역할주요·보조 역할·수행 범위·제외 범위
지식입력 데이터·출처·Evidence·온톨로지·규칙
실행판단 질문·출력·추천 행동·도구/API
통제권한·금지 행동·Human Gate·승인자
운영예외·실패 처리·감사 로그·KPI
08단계 완료 체크리스트
Agent 목적과 해결 문제가 명확함
주요·보조·제외 역할이 분리됨
입력 데이터와 출처·품질 조건이 정의됨
Evidence·온톨로지·규칙이 연결됨
판단 질문과 출력 결과가 정의됨
도구/API와 입력·출력이 등록됨
권한 수준과 금지 행동이 지정됨
Human Gate 승인 조건과 승인자가 연결됨
실패 처리와 수동 전환이 정의됨
감사 로그 필수 항목이 확정됨
Agent KPI와 자산화 조건이 설정됨
다음 단계 워크플로 설계로 전달됨
08\uB2E8\uACC4의 최종 목적
AI 판단 시나리오를 재사용 가능한 Agent 역할로 전환하고, 도구·권한·승인·실패 처리·감사 로그·KPI를 함께 설계하여 안전한 업무 구성요소로 만드는 것입니다.
